home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 1.iso / ARGONET / PD / FILER / BBC2RPC.ZIP / README.TXT < prev   
Text File  |  1997-01-25  |  6KB  |  201 lines
  1.                              BBC2RPC     Version 1.00
  2.                              ------------------------
  3.    
  4.                              Paul Theobald (25/01/97)
  5.                        
  6.  
  7. Introduction
  8. ------------
  9.    
  10. BBC2RPC is a file transfer utility to copy files between two Acorn computers
  11. over a serial link.
  12.  
  13. The program was primarily written for copying files from the author's old
  14. BBC micro to a new generation RiscPC, hence its name, though as it's
  15. written entirely in BBC BASIC the software should work on virtually all
  16. Acorn machines supporting a serial interface.
  17.  
  18. The program is deliberately designed to be small, simple and low on
  19. features.  This is so that:
  20.  
  21. - Exactly the same program can be run ay each end of the serial line.
  22.   This makes maintenance and upgradability much easier.
  23.   
  24. - The program is as fast and efficient as possible.  
  25.   
  26. - The program is small enough that it's viable to be typed in by hand.
  27.   This is necessary to avoid the 'chicken and egg' situation -- it's likely
  28.   there's no other way to get this program onto both machines, otherwise why
  29.   would you be wanting to use it in the first place?
  30.             
  31.                    
  32. Requirements
  33. ------------
  34.  
  35. The program is written to use BBC BASIC level II or above.  If necessary it
  36. could be easily modified to work on level I.
  37.  
  38. It requires an RS423/RS232 serial port accessible via *FX and OSBYTE calls.
  39.  
  40. The serial port on the two machines must be connected by a suitable serial
  41. cable.  Thses can be purchased from Acorn suppliers or alternatively nip
  42. down to your local electronics store and for a couple of quid you can make
  43. one up yourself (see the 'Wiring' section below for details).
  44.  
  45. The program must be loadable on both machines.  Depending on your hardware
  46. you may be able to do this simply by transfer via disks, or alternatively
  47. through judicious use of *FX and *SPOOL calls at the command line (though
  48. this seems fraught with difficulties particularly on the Risc PC).
  49. Alternatively it may be quicker to just type it in manually.  All you need
  50. is enough of the program to provide a bootstrap mechanism for transferring
  51. the whole program later on.  The program is stuctured in such a way that
  52. the pieces you don't need (ie the 'send' and 'write_' procedures) can be
  53. left out.  Additionally, missing out REM statements reduces this further
  54. to just over 60 lines of code.
  55.  
  56.  
  57. To Use
  58. ------
  59.  
  60. Firstly, start the program on both machines.  You will be prompted with the
  61. following line:
  62.  
  63.   (S)end, (R)eceive, (*) command, (Q)uit?
  64.  
  65. Press one of the bracketed characters to do the corresponding operation.
  66.  
  67. - Hit 'S' to send a file.  It will then prompt for a file name.  Note that
  68.   this is limited to 7 characters, and directory separators are not allowed.
  69.   You will need to make sure you're in the right directory before you can
  70.   send it.  (Use the * command option to do this).  The other machine must
  71.   be  in 'receiving' mode before the send will start.
  72.   
  73. - Hit 'R' to receive a file.  It does not prompt for a file name, as the
  74.   one from the sending end is used.  It will be saved to the current
  75.   directory, so again make sure you're in the right directory before you
  76.   start.  Note that only the file name, file size and the contents of the
  77.   file itself are sent.  File attributes such as load address or
  78.   modification date are not transferred and will need to be set up by hand.
  79.   
  80. - Hit '*' to issue an operating system command.  In particular the following
  81.   commands are useful:
  82.   *CAT to list the files in the current directory
  83.   *DIR to change the current directory.
  84.   
  85. - Hit 'Q' to quit the program. 
  86.  
  87.  
  88. Configuration
  89. -------------
  90.  
  91. Configuration of the serial line is minimised by using operating system
  92. defaults.  The only configurable option is the baud rate.  Alter the
  93. initialisation of the baud_rate% variable at line 300 for different line
  94. speeds.  Of course, both ends of the connection must be configured to use
  95. the same baud rate.  The variable takes a value from 1 to 8, with meaning:
  96.  
  97.   1 -    75 baud
  98.   2 -   150 baud
  99.   3 -   300 baud
  100.   4 -  1200 baud
  101.   5 -  2400 baud
  102.   6 -  4800 baud
  103.   7 -  9600 baud
  104.   8 - 19200 baud
  105.  
  106. This comes pre-configured at 9600 baud.  In practise (at least on a BBC
  107. micro) the speed is limited by the BASIC interpreter rather than line speed.
  108.  
  109.  
  110. Wiring
  111. ------
  112.  
  113. Wiring between machines of the same type should be straightforward, and is
  114. often described in the User Manuals.
  115.  
  116. However, between machines of the different architectures wiring gets more
  117. complicated.  One thing to note is that the BBC micro uses the RS232 lines
  118. in a different way to the de-facto standard PC (and RiscPC), namely the
  119. BBC micro's use of the RTS/CTS lines more closely corresponds to the PCs
  120. DTR/DSR lines than the true RTS/CTS definitions (a good description can be
  121. found in "The New Advanced User Guide" by Dickens & Holmes).
  122.      
  123. Not having access to other machines in the range, the only wiring details
  124. I give here are of the BBC micro and RiscPC.
  125.      
  126. BBC 5-pin domino socket - view of socket from back of computer
  127.  
  128.         _____  
  129.       /       \
  130.      / 5o   o4  \
  131.     |           |
  132.      )   1o     |
  133.     |           |
  134.      \ 2o   o3 /
  135.       \ _____ /
  136.       
  137.       
  138. RiscPC 9-way D-type plug - view of plug from back of computer
  139.  
  140.        1   2   3   4   5
  141.      _____________________
  142.     |  o   o   o   o   o  |
  143.      \   o   o   o   o   /
  144.       \_________________/
  145.          6   7   8   9
  146.  
  147.  
  148. The following shows the simplest wiring I've found to work reliably
  149. between a BBC and RiscPC.
  150.  
  151.     RiscPC                  BBC
  152.  
  153.    1 DCD <---+
  154.    2 RxD <---|------------> TD  3
  155.    3 TxD <---|------------> RD  2
  156.    4 DTR <---+------------> CTS 2
  157.    5 0V  <---|------------> Gnd 1
  158.    6 DSR <---|------------> RTS 5
  159.    7 RTS     |
  160.    8 CTS <---+
  161.    9 RI
  162.  
  163.  
  164. Contacts
  165. --------
  166.  
  167. Please send me any comments, bug reports, new info or suggestions.
  168.  
  169. I can be contacted at the following addresses:
  170.  
  171. SMTP:  pt@datcon.co.uk
  172. X.400: c=GB;a=TMAILUK;p=DCNET;s=Theobald
  173.  
  174. Paul Theobald
  175. 29 Lavender Gardens
  176. Enfield
  177. Middx  EN2 0TP
  178. UK
  179.  
  180.  
  181. Distribution
  182. ------------
  183.  
  184. This software is 'Public Domain'.  Feel free to copy, modify or distribute it
  185. so long as it remains in the public domain.  If you do make any useful
  186. modifications please let me know so I can incorporate them into future
  187. versions.
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.                             
  200.  
  201.